---
title: xDashBoard passthrough operations
summary: Direct 1:1 passthrough methods to the xPression Design SOAP proxy for xDashBoard integration.
status: draft
owner: SAIF Case Management
last_reviewed: 2026-08-21
library: SAIF.Services.Printing
reference_type: embedded
operation_id: OP-PRINT-XDASHBOARD
trigger: Caller invokes clsPrint.xpublishDocument, xpreviewHTML, xpublishAndReturnDocument, xdocumentsForCategory, xoutputProfilesForDocument, or xcategoriesForUser
---

# xDashBoard passthrough operations

A set of direct 1:1 passthrough methods on `clsPrint` that forward xDashBoard integration requests to the xPression Design SOAP service with no additional local logic.

| Field | Value |
| --- | --- |
| **Operation ID** | OP-PRINT-XDASHBOARD |
| **Trigger** | Caller invokes any of `xpublishDocument`, `xpreviewHTML`, `xpublishAndReturnDocument`, `xdocumentsForCategory`, `xoutputProfilesForDocument`, `xcategoriesForUser` |
| **Inputs** | Varies by method (document package/XML, category, user identifier) |
| **Outputs** | Varies by method (byte arrays, strings, or string arrays) |
| **Primary components** | `clsPrint.xpublishDocument`, `clsPrint.xpreviewHTML`, `clsPrint.xpublishAndReturnDocument`, `clsPrint.xdocumentsForCategory`, `clsPrint.xoutputProfilesForDocument`, `clsPrint.xcategoriesForUser` |
| **Entry point** | `SAIF.Services.Printing\clsPrint.vb` |

## Steps

1. Each method is a direct 1:1 passthrough to the corresponding method on `m_Xpresso` (the `xpresso.clsGenerate` SOAP proxy), with no additional local logic, validation, or state changes.
   > **Origin**: These steps are implemented in `xpresso.clsGenerate` (`SAIF.Services.Printing.xpresso`) and executed against the external xPression Design server.*
2. Return values are passed back unchanged (byte arrays, strings, or string arrays depending on the operation).

## Process flow

```mermaid
flowchart TD
	Start([Caller invokes passthrough method]) --> Forward[Forward call to m_Xpresso equivalent method]
	Forward --> Soap[SOAP call to external xPression server]
	Soap --> Return([Return value unchanged])
```

## Failure and edge-case behavior
- No local validation or error handling wraps any of these passthrough calls; SOAP faults propagate directly to the caller.*

## Related documentation
- [Operations and processes](../operations-processes.md)
- [Business rules](../business-rules.md)

## Sources
- `SAIF.Services.Printing\clsPrint.vb`
- `SAIF.Services.Printing\Web References\xpresso\Reference.vb`
